Load Image using Picture

When PictureEnabled is set to true, an image can be loaded by setting the Picture property to the Picture property of a Form object, PictureBox control, or Image control. (e.g. VB LoadPicture function)

The ImagXpress® Picture property supports picture type BITMAP only. It does not support ICON or METAFILE. When an image loads using the Picture property, the Picture property stores the DDB (BITMAP). The image is stored as a DIB in an ImagXpress buffer (identified by the ProcessImageID property). If an Undo DIB resides in memory, it is deleted and the hDIBUndo property is set to NULL. The ViewImageID property is set to the newly loaded image, enabling the display of the new image.

The Picture property of the control has size limitations due to limitations of the Windows API. Although the Windows SDK does not document this limitation, our tests indicate that the limitation is approximately 16 MB. If the Picture property is set to an image that exceeds this size, the ImagError property is set, the ImagXpress Picture property is not set, and the image is not loaded into an ImagXpress buffer.